Skip to main content

Save and Export

Save and Export

Futuremaps is a client-side only application. In the app, the data you uploaded stays in your browser. Futuremaps does not send or store any user data to any backends. This rule poses a limitation on how you can save and share your maps.

However, in the demo app, you can:

Export Image​

Export Image

You can export the current map as an image. The export window will use the current map viewport, and the preview will show the entire exported map area. To adjust the viewport, you will have to close the export dialogue. You can choose different export ratios or resolutions, and also add a map legend.

Export Data​

Export Data

You can export map data as a CSV file, with the option to export ONLY the filtered data or the entire dataset.

Export Map​

You can export the current map using two different formats. The Export Map window provides two options:

  • HTML: create a single HTML file that loads and renders your current map.
  • JSON: create a JSON file with your current map config and data.

Export Map as HTML​

Export Map as HTML

To save and export your current map as an HTML file, click on Export Map and subsequently on Export. When prompted provide your own Mapbox token to be used in the newly generated file. If you don't provide a Mapbox Token, Futuremaps will use a default one which can expire at any time without any communication and therefore break your existing map.

How to update an exported map token​

In order to edit the Mapbox token in your HTML file you simply need to perform the following steps:

  1. Create a new Mapbox token or use your existing one.
  2. Open the futuremaps.map file with your favourite text editor.
  3. Locate the following line in the exported file kepler.gl.html:
  /**
   * Provide your MapBox Token
   **/
  const MAPBOX_TOKEN = 'CURRENT_TOKEN';
  1. Replace the current value with a new valid token. The code should now look like the following:
  /**
   * Provide your MapBox Token
   **/
  const MAPBOX_TOKEN = 'pk.eyJ1IjoidWJlcmRh...';

Export Map as JSON​

Export Map as JSON

You can export the current map as a JSON file. This is useful when you are running your own kepler.gl application and want to load your map programmatically.

The JSON file includes:

  • dataset: processed data to create used to render your map
  • config: layer, filter, map style and interaction settings. The map config includes the current layer, filter, map style and interaction settings.

Note: Futuremaps map config is coupled with loaded datasets. The dataId key is used to bind layers, filters and tooltip settings to a specific dataset. If you try to upload a configuration with a dataset in your own Futuremaps app, you also need to make sure your dataset id matches the dataId in the config.

Share Public URL (Dropbox) ​

Export Map to Dropbox

To export the current map into your Dropbox account, click on Share Public Url and select Dropbox as your cloud storage. Perform the authentication against Dropbox using your credentials. Once the authentication process is completed, click on Upload and Futuremaps will push your current map onto your account.

At the end of the process, Futuremaps will automatically generate a permalink for your work you can share with other users.